home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / AVOGADRO / GRAPHING / GRAPHDRAW / !GraphDraw / Resources / EditHelp < prev    next >
Text File  |  1995-04-22  |  9KB  |  307 lines
  1. Information is available on:
  2.  
  3.   What This Software Does
  4.   Entering Data
  5.   The Graphdraw Edit Window Menu
  6.   Graph Window Menus
  7.   Further Information
  8.  
  9.   WIMP Key Presses
  10. ________________________________________
  11.  
  12. Note that if any read me files are
  13. supplied as part of this application,
  14. they may have more recent information
  15. than is contained in this file.
  16.  
  17. GraphDraw is © Chris Johnson, 1992
  18. ________________________________________
  19.  
  20. This application provides interactive
  21. help when the !Help application is
  22. active.
  23. ________________________________________
  24.  
  25. What This Software Does
  26.  
  27. It allows the entry of the x and y
  28. values for a number of data, and the
  29. data may then be fit to
  30.  
  31. a. best straight line
  32. b. best parabola
  33. c. a cubic spline curve
  34. d. a polynomial of order up to 6
  35.  
  36. A number of options for obtaining
  37. various forms of hard copy exist
  38. (saving as a !Draw file, or printing via
  39. any standard RISC-OS printer driver).
  40.  
  41. ________________________________________
  42.  
  43. Entering Data
  44.  
  45. Clicking SELECT on the iconbar icon will
  46. open an empty edit window, into which
  47. the pairs of x,y data may be entered.
  48. This version allows a maximum of 200
  49. data point pairs.
  50.  
  51. Full scrolling and editing facilities
  52. are available during data entry, by
  53. means of the arrow keys, either alone or
  54. in conjunction with SHIFT or CTRL. Page
  55. up/down are the same as SHIFT+arrow. One
  56. useful key combination is
  57. CTRL+SHIFT+COPY, which will delete the
  58. data point at the cursor and close up
  59. the rest of the data.
  60.  
  61. The function key f3 will bring up the
  62. standard save as dialogue box (this is
  63. provided also as a menu choice). 
  64.  
  65. Double clicking on a GraphDraw data file
  66. or dragging a data file either into the
  67. edit window, or to the iconbar icon will
  68. load the data, overwriting any data that
  69. had previously been entered.
  70.  
  71. Besides files in GraphDraw format, files
  72. of file type text, data or CSV can be
  73. loaded by dragging into the edit window
  74. or onto the iconbar icon. In some cases,
  75. if the file does not start with the
  76. standard graphdraw header, a query
  77. window will open for confirmation before
  78. loading the file.
  79.  
  80. Data can also be passed in either
  81. direction between the GraphDraw edit
  82. window and a !edit window. Thus editing
  83. can be carried out using the !edit
  84. application if preferred. Data can be
  85. entered 'from scratch' using !edit, and
  86. then transferred to the !GraphDraw
  87. application (by dragging a save icon to
  88. its edit window or its iconbar icon), as
  89. long as the !GraphDraw application can
  90. recognise a valid data file. This
  91. version of !GraphDraw now supports
  92. direct RAM transfer for all its loading
  93. and saving operations.
  94.  
  95. As the graphdraw application will deal
  96. with files of comma separated ASCII data
  97. it is possible to set up other
  98. applications to produce data files of
  99. the correct form.
  100.  
  101. Error Bars
  102. If the Error bars icon at the bottom of
  103. the edit window is selected by clicking
  104. on it, the edit window will be extended,
  105. allowing access to two further columns
  106. of data. These are for use in entering
  107. error limits to the points. The minimum
  108. y limit and maximum y limit for each
  109. point may be entered. When the graph is
  110. plotted, the error bars corresponding to
  111. these limits will be plotted.
  112.  
  113. In some cases it may be sufficient to
  114. use a constant fraction for the error
  115. bars. This may be done very simply by
  116. entering the percentage error, e.g. 10,
  117. into the writable icon, and then
  118. clicking on the "Calc constant %" icon.
  119. The calculated values will then be
  120. written into the tables of data.
  121.  
  122. If the error bars icon is deselected,
  123. the edit window will contract to the
  124. normal size, and the error bars will not
  125. be plotted. The data is retained, and
  126. may be plotted again by reselecting the
  127. error bars icon.
  128. ________________________________________
  129.  
  130. The GraphDraw Edit Window Menu
  131.  
  132. All of the data processing and data
  133. display facilities are accessed from the
  134. edit window menu.
  135.  
  136. Clicking the 'menu' button in the edit
  137. window brings up the following choices.
  138.  
  139. Clear data
  140.  This will irretrievably clear the
  141. current data prior to the entry of new
  142. data. Graphdraw asks for confirmation
  143. before clearing the data.
  144.  
  145. Save file
  146.  Data files may be saved by dragging the
  147. save icon to a directory viewer. If the
  148. full path name is set up, then you can
  149. also click on the OK icon to save the
  150. data.
  151.  
  152. The function key F3 can be used as a
  153. short cut for this option (unless the
  154. graph window is open, when F3 will bring
  155. up the "save drawfile" dialogue box).
  156.  
  157. It is also possible to drag the save
  158. icon to a !Edit window, or to the !Edit
  159. icon on the iconbar. The data is then
  160. transferred into !Edit.
  161.  
  162. Plot points
  163.  This will simply plot a scaled graph of
  164. the data. Additional sub-menu choices
  165. allow you to plot the data as is, as
  166. semi-log x, semi-log y or as a log-log
  167. plot.
  168.  
  169. Join points
  170.  This plots the points and joins each
  171. point to the next with a straight line.
  172. The log plotting options are available
  173. as above.
  174.  
  175. Best line
  176.  This will carry out a standard linear
  177. regression by the least squares method
  178. to calculate the best fit straight line
  179. through the data. A window will open
  180. displaying the slope, intercept on y
  181. axis, correlation coefficient and the
  182. standard errors of the slope and
  183. intercept. Clicking 'menu' in this
  184. window allows the following choices.
  185.  
  186.    Graph
  187.    -----
  188.    This will display a graph of the data
  189. points with the calculated best line
  190. superimposed. Clicking 'menu' in the
  191. graph window then leads to a further set
  192. of options.
  193.  
  194.    Print data
  195.    ----------
  196.    This will send the results of the
  197. calculation to any printer connected to
  198. the computer. The individual errors
  199. calculated for each data point are also
  200. printed.
  201.  
  202. Parabola
  203.  This will carry out a least squares fit
  204. of the data to the equation of a
  205. parabola
  206.  
  207.       y = u + vX + wX^2.
  208.  
  209. This is a useful technique for fitting
  210. data to a simple curve. A window will
  211. open showing the calculated values of
  212. the coefficients u, v and w. Clicking
  213. 'menu' in this window will bring up the
  214. same two options as described above,
  215. i.e. graph and Print data.
  216.  
  217. Polynomial
  218.  This will carry out a standard
  219. polynomial fit for orders 3 to 6. Some
  220. of the higher order options may be
  221. greyed out if there are not enough data
  222. points. Selecting a particular order
  223. will force the program to calculate that
  224. specific order polynomial, whereas if
  225. 'All' is selected, the program will try
  226. all possible orders (3 to 6) and report
  227. the one which gives the smallest
  228. deviation. A window will open showing
  229. the results of the calculation, and
  230. clicking 'menu' on this window leads to
  231. the same options as above.
  232.  
  233. Cubic spline
  234.  This option leads to a small dialogue
  235. box, which at present simply requests
  236. the 'fit factor' to be specified. This
  237. value must lie BETWEEN 0 and 1. In
  238. theory, a value of 0 will plot a
  239. straight line through the points, while
  240. a value of 1 will force the curve
  241. through every point. In practice these
  242. values cannot be used, since a divide by
  243. zero error is generated during certain
  244. matrix inversion operations. Little is
  245. lost since a value of 0.9999 or 0.0001
  246. will give essentially the same result as
  247. 1 or 0. Curve fitting is always very
  248. subjective, and it is up to the user to
  249. decide the degree of smoothing
  250. acceptable for any particular set of
  251. data. A value of 0.5 is an obvious
  252. starting point for any data known to
  253. have scatter or experimental error.
  254.  
  255. Once <return> is pressed, the spline
  256. plot will be displayed. For this plot,
  257. it requires all the data to be sorted in
  258. order. The program automatically sorts
  259. the data in ascending order of x values
  260. before carrying out the spline routine.
  261. Note that this sorting occurs whenever
  262. any of the plotting routines are used.
  263.  
  264. Transform X
  265.  Allows the x data to be transformed in
  266. a number of standard ways, e.g. LOG,
  267. reciprocal. These operations are
  268. cumulative, but it is up to the user to
  269. remember the sequence of
  270. transformations. Only the last
  271. transformation can be "undone".
  272.  
  273. Transform Y
  274.  As for transform X but on the y data.
  275.  
  276. Swap X and Y
  277.  Simply interchanges the x and y data
  278. pairs.
  279. ________________________________________
  280.  
  281. Graph Window Menus
  282.  
  283. Whenever a graph is being displayed,
  284. clicking 'menu' will lead to a further
  285. range of options.
  286. ________________________________________
  287.  
  288. Further Information
  289.  
  290. Help windows with appropriate text are
  291. also available from the Iconbar menu,
  292. and from the graph window menu.
  293. ________________________________________
  294.  
  295. WIMP Key Presses
  296.  
  297. Function key F1 attempts to start up
  298. either !Help or !BubbleHelp. 
  299.  
  300. Function key F3 brings up a "save as"
  301. dialogue box for saving the data (or the
  302. graph as a draw file, depending on
  303. whether a graph is being displayed at
  304. the time).
  305. ________________________________________
  306.  
  307.